home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / ts440c.arc / TS440CTL.DOC next >
Encoding:
Text File  |  1988-01-17  |  14.8 KB  |  313 lines
  1. CB
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                           Kenwood TS-440 Low Band Computer
  8.                              Interface Control Program.
  9.             
  10.             Required Equipment:
  11.             
  12.                  IBM PC or Compatible with 128K memory (MIN) and a DSDD
  13.                  floppy disk drive.
  14.                  
  15.                  CGA or EGA Color Monitor
  16.             
  17.             Chapter 1.  Description
  18.             
  19.                  Upon  release   of  the   Kenwood   TS-440   low   band
  20.                  transceiver,  Kenwood   also   announced   a   computer
  21.                  interface option.   This  interface allows  control  of
  22.                  most front  panel aspects of the rig.  The only problem
  23.                  was that  no software  to control the rig was ever sold
  24.                  to use the powerful protocol.  That is until now.
  25.             
  26.                  TS440ctl.exe allows  the user  complete remote  control
  27.                  ability from a Personal Computer screen.  The following
  28.                  are the commands and controls available to the user:
  29.                  
  30.                       VFO A Frequency
  31.                       VFO B Frequency
  32.                       Memory Channel Selection
  33.                       Tuning
  34.                       RIT switch, tune, and dial
  35.                       Band selection
  36.                       Scan
  37.                       Split
  38.                       Lock
  39.                       Mode
  40.                  
  41.                  In  addition  to  the  above,  status  of  the  440  is
  42.                  constantly  updated  on  the  PC  screen.    With  this
  43.                  program, the  user may  access almost every function of
  44.                  the 440 from the PC.
  45.             
  46.             Chapter 2,  Setting Up for TS440ctl
  47.                  
  48.                  As mentioned above, TS440ctl contains a real time clock
  49.                  that reflects GMT time.  In order for the GMT time to
  50.                  be correct, you must first make sure that your system
  51.                  clock is set correctly for YOUR time zone.  Also, a new
  52.                  command must me inserted into your autoexec.bat file.
  53.                  If you are not familiar with this file, consult your
  54.                  DOS reference manual for details.
  55.                  
  56.                  TS440ctl needs to know the time zone that it is running
  57.                  in so that it may determine the correct number of hours
  58.                  to correct for Greenwich Mean Time.  The program
  59.                  figures this out by looking for a value called
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                  timezone.   You set timezone to one of the following
  66.                  values:
  67.                  
  68.                       EDT  - Eastern Standard Time
  69.                       CDT  - Central Standard Time
  70.                       MDT  - Mountain Standard Time
  71.                       PDT  - Pacific Standard Time
  72.                  
  73.                  Enter the following line into your autoexec.bat file,
  74.                  or just enter at the DOS prompt:
  75.                  
  76.                       set timezone=XXX
  77.                       
  78.                  where XXX is the timezone where you reside.  The
  79.                  advantage to entering this into your autoexec.bat is
  80.                  that is saves the step each time you want to run the
  81.                  program.  The program defaults to MDT time, for that is
  82.                  the time zone I live.
  83.                       
  84.                  The TS-440  communicates with  the PC via an RS-232 EIA
  85.                  connection.   This is  typically connected to your PC's
  86.                  COM1 port.   A  3 wire  RS-232 cable  connects  to  the
  87.                  kenwood   communications    interface.       For   more
  88.                  information, refer  to the installation manual included
  89.                  with the interface unit.
  90.             
  91.             Chapter 3,  Using TS440ctl.exe
  92.             
  93.             Start-Up
  94.                  TS440ctl is started by typing
  95.                  
  96.                       TS440CTL
  97.                  
  98.                  at the DOS command line.  If you have a hard disk, make
  99.                  sure that you are in the directory, or have a path to
  100.                  the directory in which the program resides.  If you
  101.                  wish to use the second COM port (COM2), type
  102.                  
  103.                       TS440CTL 2
  104.                  
  105.                  When the program begins execution, you should hear the
  106.                  radio beep several times.  This is normal.  If the
  107.                  radio does not beep, check to see that all cables are
  108.                  properly connected and you are using the proper serial
  109.                  COM port for your computer.
  110.                  
  111.                  The start up status of the program is VFO A.  What ever
  112.                  frequency was tuned at the time of last use is the
  113.                  current frequency, as well as the mode, scan status,
  114.                  rit status and so on.  This information should
  115.                  immediately be updated on the screen.
  116.                  
  117.                  
  118.                  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.             The Screen
  125.                  The  screen   for  TS440CTL  is  divided  into  several
  126.                  sections.   Each section  contains related information.
  127.                  For example, the top of the screen contains the current
  128.                  status of  all the  functions available,  that is VFO A
  129.                  frequency, VFO  B frequency, and current memory channel
  130.                  and channel frequency.  Based on the selected function,
  131.                  the word  above the  function will  be  illuminated  to
  132.                  indicate the  current selection.   The  current mode is
  133.                  also positioned on the first sector of the screen.
  134.             
  135.                  The second  sector contains  a "meter"  indicating  the
  136.                  current band. Based upon the current band, a pointer is
  137.                  placed under  the  band  position  on  the  meter.  The
  138.                  current XIT  and LOCK  status are  on the right side of
  139.                  the screen.
  140.             
  141.                  The center  of the  screen contains the current display
  142.                  frequency, RIT  status,  and  current  RIT  offset.  In
  143.                  addition, another  function indicator  is  provided  so
  144.                  that, by  looking at  this sector  alone, the  user can
  145.                  obtain most  of the  significant information  regarding
  146.                  the status of the radio.
  147.             
  148.                  The next sector contains the current scan status, spilt
  149.                  status, and  a graphic  indication of  the current  RIT
  150.                  offset.  A real time clock is also included.
  151.             
  152.                  An  lastly,   the  bottom  of  the  screen  contains  a
  153.                  reference of  all  the  control  commands  used.    The
  154.                  following sections  describe these  control commands in
  155.                  detail.
  156.             
  157.             Chapter 4, Keyboard Commands
  158.             
  159.                  Several PC  keys are  used to control the various front
  160.                  panel aspects  of  the  TS-440.    These  commands  are
  161.                  described here:
  162.             
  163.                  Function Keys
  164.                       F1   -    Decrements the current frequency by the
  165.                                 current step rate.
  166.                       
  167.                       F2   -    Increments the frequency by the current
  168.                                 step rate.
  169.                       
  170.                       F3   -    Decrements the RIT offset.
  171.                       
  172.                       F4   -    Increments the RIT offset.
  173.                       
  174.                       F5   -    Toggles the status of the RIT (on/ off).
  175.                       
  176.                       F6   -    Toggles the XIT status.
  177.                       
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                       F7   -    Select frequency for VFO A.
  184.                                 This command will prompt the user for a
  185.                                 frequency to be placed into VFO A.
  186.                            
  187.                       F8   -    Same as above for VFO B.
  188.                       
  189.                       F9   -    Select Memory Channel.  This command     
  190.                                 prompts the user for the memory channel
  191.                                 desired.
  192.                       
  193.                       F10  -    Exit, quit the program.
  194.                       
  195.                       A    -    Switch to VFO A
  196.                       
  197.                       B    -    Switch to VFO B
  198.                       
  199.                       C    -    Clear current RIT offset.  This command
  200.                                 allows you to have the radio ignore the
  201.                                 current position of the RIT controller,
  202.                                 and use exclusively the remote control.
  203.                                 Note that if the control is moved on the
  204.                                 rig, the current controller position is
  205.                                 restored, and the program is updated as
  206.                                 to its status.
  207.                       
  208.                       M    -    Select memory as current function
  209.                       
  210.                       O    -    Select Mode.  This key scrolls through   
  211.                                 all the possible modes of the TS440 (AM,
  212.                                 FM, CW, ect...).
  213.                       
  214.                       P    -    Toggle split status.
  215.                       
  216.                       S    -    Toggle Scan Status.
  217.                       
  218.                       T    -    Transmit/ Receive toggle.  (Careful!)
  219.                       
  220.                       Alt F7-   Memory to VFO copy.
  221.                                 This command prompts for which VFO to    
  222.                                 copy to, and the channel you wish        
  223.                                 copied.
  224.             
  225.             Other notes
  226.                  While using  ts440ctl, you  may notice  that the screen
  227.                  updates do  not always  track the  status of the radio.
  228.                  In reality, the problem lies with the radios ability to
  229.                  relay information  back  to  the  PC.    The  interface
  230.                  specification states  that  an  update  of  information
  231.                  takes  place   every   1.5   seconds.   This   can   be
  232.                  misunderstood to  mean that at any time, information is
  233.                  updated every  1.5 seconds.   This,  in fact is not the
  234.                  case.   When activity  takes place on the radio, either
  235.                  using the  front panel  controls or  the PC,  an update
  236.                  will not  take place  until the  radio  sits  idle  for
  237.  
  238.  
  239.  
  240.  
  241.  
  242.                  approximately 1.5  seconds.   A good example of this is
  243.                  spinning the  dial while watching the PC screen running
  244.                  ts440ctl.   You should  notice an  update taking  place
  245.                  AFTER the  spin has  stopped.  To counter this example,
  246.                  placing the  radio in  scan  mode  updates  the  screen
  247.                  approximately every  1.5 seconds.    From  the  limited
  248.                  information in  the documentation of this interface, it
  249.                  is not  possible to determine the exact pattern or rule
  250.                  chosen for  this, but  the end  result is  a  sometimes
  251.                  sluggish interface to this program.
  252.             
  253.                  During development  of this  program, every  effort was
  254.                  made to  insure that  status of the screen reflects the
  255.                  actual status  of the  radio.   If, at  some time,  you
  256.                  notice that  the screen  does not  reflect that status,
  257.                  perform some  action on  the keyboard, for example tune
  258.                  up and  then down.  This change should prompt the radio
  259.                  to update the status of the PC.
  260.             
  261.                  If you  use one  of the many keyboard speed up programs
  262.                  available, be  warned that if you hold a key down, then
  263.                  every key  will count.   For  example, if  you tune  by
  264.                  holding the  F1 key  down, it  may go  further that you
  265.                  want.
  266.             
  267.                  This program was written in Borland International Turbo
  268.                  C environment.   It  has been  tested on an PC/AT clone
  269.                  and a Tandy 1000.  If your PC is a close compatible, it
  270.                  should run  fine.   If  you  encounter  problems,  have
  271.                  suggestions, or just have questions drop me a line at
  272.             
  273.                                       Kenneth Byers
  274.                                            or
  275.                                    David Byers (W9HXL)
  276.                                  4813 West Greenway Road
  277.                                   Glendale, AZ   85306
  278.             
  279.                  If you find this program useful, please help a starving
  280.                  computer science  student by  mailing a donation to the
  281.                  above address.   In  addition to  the charity value, it
  282.                  will insure  that you  are notified of upgrades to this
  283.                  program.   Some of  the upgrades I am currently working
  284.                  on are:
  285.                  
  286.                       Bulk Memory Transfers which will allow you to keep
  287.                       libraries of  memory channels  on disk, and upload
  288.                       and download them to and from the radio.
  289.                       
  290.                       VFO to  Memory channel  storage which  will  allow
  291.                       you, at  the touch of a key, to store the contents
  292.                       of the current VFO to any memory channel.
  293.                       
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                       Utilities that  allow you  to manipulate memories,
  300.                       as well  as selecting  a memory VIA station ID, or
  301.                       any other comment field.
  302.                       
  303.                       Band Tracking,  allowing you  to select only legal
  304.                       HAM bands,  short wave  bands, or  a user  defined
  305.                       band pattern.
  306.                       
  307.                  It took  quite a  while  to  accumulate  the  knowledge
  308.                  required to  write a  program  of  this  type,  so  the
  309.                  recognition would  make it  all seem  worth while.    I
  310.                  would  suggest   a  possible  donation  of  20.00,  but
  311.                  anything helps.
  312.             
  313.                                Thank you, and enjoy.